home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: Alpha / Whiteline Alpha.iso / tools / cpx_acc / cpx / mcwr_snd.txt < prev   
Encoding:
Text File  |  1994-09-22  |  7.3 KB  |  213 lines

  1. Einen wunderschönen guten...
  2.  
  3. Dies ist der Versuch einer Dokumentation für:
  4.  
  5.                      MCWR_SND.CPX  Version 1.0
  6.  
  7.  
  8. Einleitung
  9.  
  10.   Das vorliegende CPX ist ein Ersatz für das SOUND.CPX von ATARI.
  11.   Die Bedienung ist im Prinzip die gleiche; deshalb werde ich nur auf die 
  12.   Änderungen eingehen. Eigentlich erklärt sich sowieso alles von selbst.
  13.   (Warum tippe ich das hier eigentlich?)
  14.   
  15.   Falls jemand eventuell auftretende Seitenhiebe, Sticheleien oder sonstiges 
  16.   nicht versteht, dies aber gerne möchte, dem kann ich nur folgendes 
  17.   empfehlen:
  18.   
  19.   
  20.   - Einstieg in die DFÜ (falls nicht schon geschehen)
  21.   - Eintragen in die Mailbox  MAUS WI2
  22.   - Beitrag zahlen
  23.   - Regelmäßig 'ÖFFENTLICH' lesen
  24.   
  25.   Wem dann immer noch nicht alles klar ist:
  26.   
  27.   - Gruppenchef und Beta-Tester für 'Zeig's mir' werden (letzteres ist so 
  28.     ziemlich unmöglich)
  29.   - Regelmäßig 'GRUPPE CHEF' und 'ZEIGSMIR' lesen
  30.   
  31.   Schon nach wenigen Tagen wird sich dann ein nicht reversibler Effekt 
  32.   einstellen... Aber dafür versteht man dann auch das, was man wissen wollte.
  33.   
  34.   
  35.   
  36. Das 'Warum'
  37.  
  38.   Diese Frage sollten sich viele Programmierer stellen!
  39.   
  40.   In meinem Fall war es so, daß ich auf ein Programm stieß (Zeig's mir), das 
  41.   den MCWR-Cookie unterstützt (Erklärung kommt gleich). Leider fand ich kein 
  42.   Programm, daß diesen vernünftig einstellt.
  43.   
  44.   Dazu gesellte sich der Umstand, daß das SOUND.CPX von ATARI unter Hi und 
  45.   TrueColor (zumindest auf der NOVA) abstürzt...
  46.  
  47.   
  48.   
  49. Der MCWR-Cookie
  50.  
  51.   Dieses kleine Gebilde soll ein Manko der ATARI-DMA-Sound Unterstützung 
  52.   ausmerzen. Es gibt nämlich keine!
  53.   
  54.   ATARI hat leider versäumt, Betriebssystemaufrufe einzuführen, die den 
  55.   DMA-Sound beeinflussen. Noch schlimmer ist die fehlende Möglichkeit, den 
  56.   momentanen Status abzufragen.
  57.   
  58.   Somit wurde der Cookie kreiert - aber leider nicht von ATARI!
  59.   
  60.   Egal. In diesen Cookie schreibt man den Zustand der DMA Hardware und kann 
  61.   ihn so wieder einstellen.
  62.   
  63.  
  64.  
  65.  
  66. Das CPX
  67.  
  68.   Tja, hier isses nun. Es wird - wie alle CPXe - in den dafür vorgesehenen 
  69.   Ordner kopiert, und das war's. Das SOUND.CPX von ATARI kann man nun löschen.
  70.   
  71.   Nun die Unterschiede in Look, Bedienung und Funktion des CPX, im Vergleich 
  72.   zum Original:
  73.   
  74.   - Farbe! (Hallo Patrick, Hallo Reiner) Das CPX wurde etwas farbiger 
  75.     gestaltet, um nicht ganz so langweilig zu erscheinen. In Monochrom stellt 
  76.     sich natürlich die alte Langeweile wieder ein.
  77.     
  78.   - Keine Abstürze in Hi- oder TrueColor (Gruß an Martin und Gerhard)
  79.   
  80.   - MCWR_SND erzeugt einen MCWR-Cookie (falls nicht schon vorhanden), sofern 
  81.     dies Möglich ist; soll heißen: Ein COOKIE-Jar muß da sein, und Platz für 
  82.     den Eintrag muß er auch noch haben.
  83.  
  84.   - Der MCWR-Cookie wird benutzt!!! Beim Neuladen des CPX (oder Booten des 
  85.     Rechners) werden die gesicherten Werte eingestellt und in den COOKIE 
  86.     eingetragen. Bei jedem Aufruf des CPX werden die aktuellen Werte des 
  87.     COOKIEs eingestellt (da hilft auch 'Abbruch' nichts). Jeder Änderung folgt 
  88.     eine Aktualisierung des COOKIEs.
  89.   
  90.   - Den Lautsprecher des TT kann man abschalten. Die geschah auf Wunsch von 
  91.     50% der Beta-Tester (Danke Reiner).
  92.   
  93.   - Die selben 50% schlugen auch vor, die Beimischung des PSG-Signals 
  94.     einstellen zu können. Bitte sehr, geht auch. Der Button, neben dem PSG 
  95.     steht, öffnet ein PopUp.
  96.     
  97.     Hier kann man nun wählen ob die Ausgabe des Soundchips abgeschaltet wird 
  98.     (Aus), man die Lautstärke des PSG um 12dB absenkt (-12 dB) oder ob er 1:1 
  99.     dem DMA-Sound beigemischt wird (0 dB).
  100.   
  101.   
  102.   - Die Balance-Einstellung ist zwar prinzipiell gleich, aber die Werte werden 
  103.     anders angegeben. Zum einen stehen sie im Slider (getrennt nach 
  104.     links/rechts), zum anderen geben sie die Lautstärke des jeweiligen Kanals 
  105.     an.
  106.     
  107.     Beide auf 20 bedeutet also, Balance in der Mitte. Links auf 0 heißt 
  108.     Balance auf rechts. Das entspricht den Möglichkeiten der Hardware, die 
  109.     Lautstärke für jeden Kanal getrennt absenken zu können.
  110.     
  111.  
  112.  
  113.  
  114. Die Zukunft
  115.  
  116.   "Niemand weiß, was die Zukunft bringt"
  117.   
  118.   Das Programm ist selbstverständlich fehlerfrei. Also, "bei mir 
  119.   funktioniert's". 
  120.   Bei Thorsten funktioniert ja schließlich auch alles. (Bis auf den Eprommer) 
  121.   
  122.   
  123.   Zumindest sind bisher noch keine Netzteile oder Taschenlampen drauf 
  124.   gegangen...
  125.   
  126.   Im Klartext: Fehlerreports bitte an
  127.   
  128.      John McLoud
  129.      Mozartstraße 1a
  130.      65439 Flörsheim am Main
  131.      
  132.   oder per e-mail an:
  133.   
  134.     John Mcloud @ WI2 im Mausnetz
  135.     
  136.   
  137.  
  138.  
  139. Rechtliches
  140.  
  141.   Da es keine fehlerfreien Programme gibt (hab ich mal was anderes 
  142.   behauptet?), ist auch MCWR_SND nicht fehlerfrei.
  143.   
  144.   Der Look des Programmes (und das Icon) sind bei ATARI geklaut, hoffentlich 
  145.   ohne Konsequenzen.
  146.   
  147.   Weiterhin verwende ich in diesem Text Warenzeichen ohne Ende. Sie sind als 
  148.   solche zu betrachten, auch wenn sie nicht so gekennzeichnet sind.
  149.   
  150.   Ich übernehme aber keinerlei Garantie für irgendwas; dafür ist der Gebrauch 
  151.   des Programms auch kostenlos (hoffentlich nicht umsonst).
  152.   
  153.   Für eine Funktion auf FALCONs übernehme ich noch weniger Garantie.
  154.   Seit 'Hai Nuun' ist unser FALCON-Betatester jedem Test gegenüber etwas 
  155.   skeptisch. (Kopf hoch, Michael)
  156.   
  157.   Also, macht mich nicht für formatierte Festplatten auf FALCONs 
  158.   verantwortlich.
  159.  
  160.  
  161.   Ganz besonders übernehme ich keine Garantie für kaputte Taschenlampen, 
  162.   defekte Netzteile, leere Taschenrechner und weggeschnapptte Eprommer. 
  163.  
  164.   Ach so, das Programm ist trotz meiner Unkenntnis in 'C' geschrieben (kann 
  165.   man in GFA-Basic CPXe schreiben? Die Frage ist ernstgemeint. Ich bitte um 
  166.   Antwort).
  167.  
  168.  
  169.  
  170.  
  171. Dank an
  172.  
  173.   Alle Betatester   (war nett von Dir, Reiner; Dirk, Du mußt eh immer ran)
  174.   Dirk Haun         (Tips in 'C', Assemblerroutine für COOKIEs & Test)
  175.   Thorsten Pohlmann (Wofür danke ich dem eigentlich?)
  176.   Joachim Loder     (Die Personifizierung des zu spät kommens; Termine? Wozu?)
  177.   Volker Laut       (Für heftige Tritte, wenn ich mal wieder abhänge)
  178.   Sabine Hart       (Meine Verlobte)
  179.   Lara McLoud       (Ja, die gibt's! Frau, Du bist echt in Ordnung)
  180.   die "Bären '89"   (Dartverein in Flörsheim; Dank für schöne Stunden)
  181.   Art Guiness       (Tolles Bier)
  182.   den Arabern       (oder wer auch immer den Kaffee erfunden hat)
  183.   "House of Prince" (Ich kann mir das Qualmen einfach nicht abgewöhnen)
  184.   Michael Ruge      (Für das nicht verabreichte blaue Auge)
  185.   Carlo Guzzi       (für's Gründen einer Motorradfabrik)
  186.   
  187.   Alexander Schuster, Reiner Laun und Umberto Muscolino. (Ciao Babies!!!)
  188.   
  189.  
  190. Zum Schluß noch der MCWR-COOKIE, wie ich ihn implementiert habe:
  191.  
  192. Der Wert des MCWR-COOKIEs wird als Werte für das MICROWIRE-Interface benutzt.
  193.  
  194. Das höchste Byte steht für die Gesamtautstärke
  195. Das darauffolgende Byte repräsentiert die Lautstärke des linken Kanals
  196. Das darauffolgende Byte repräsentiert die Lautstärke des rechten Kanals
  197. Das letzte Byte wird in zwei Nibble aufgeteilt. Das höherwertige stellt den 
  198. Wert für Tiefen, das Niederwertige den für Höhen dar.
  199.  
  200. In 'C' ausgedrückt:
  201.  
  202. Der Wert des MCWR-COOKIEs repräsentiert folgende Struktur.
  203.  
  204. typedef struct
  205. {
  206.     unsignded volume: 8;
  207.     unsignded left:   8;
  208.     unsignded right:  8;
  209.     unsignded bass:   4;
  210.     unsignded treble: 4;
  211. } MCWR;
  212.     
  213.